From: Michael Catanzaro <mcatanzaro@redhat.com>
Date: Fri, 8 Sep 2023 21:21:33 +0000 (-0500)
Subject: Fix documentation of gdk_display_put_event()
X-Git-Tag: archive/raspbian/4.12.4+ds-3+rpi1^2~21^2~2^2~24
X-Git-Url: https://dgit.raspbian.org/%22http://www.example.com/cgi/success//%22http:/www.example.com/cgi/success/?a=commitdiff_plain;h=f6b96186d8f124224a92d8602cef084271906cd5;p=gtk4.git

Fix documentation of gdk_display_put_event()

This function is deprecated, but we should still document it properly.
It appends, not prepends. This is clear enough from its implementation,
but also we have practical experience with WebKit in:

https://github.com/WebKit/WebKit/pull/8663

Matthias prefers to avoid the prepend, append, start, and end
terminology altogether.
---

diff --git a/gdk/gdkdisplay.c b/gdk/gdkdisplay.c
index c1a11672da..3ea82a5743 100644
--- a/gdk/gdkdisplay.c
+++ b/gdk/gdkdisplay.c
@@ -473,8 +473,7 @@ gdk_display_get_event (GdkDisplay *display)
  * @display: a `GdkDisplay`
  * @event: (transfer none): a `GdkEvent`
  *
- * Appends the given event onto the front of the event
- * queue for @display.
+ * Adds the given event to the event queue for @display.
  *
  * Deprecated: 4.10: This function is only useful in very
  * special situations and should not be used by applications.